home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / win_q_t / tw11.zip / TWMAN.DOC < prev    next >
Text File  |  1992-10-21  |  15KB  |  304 lines
  1.  Text Watch V1.10
  2.  
  3.  Thanks to Bob Ostrander from PBS for his good suggestions.
  4.  
  5.  INSTALLATION:
  6.  Run Install before using TW and TWE. After running Install both TWE.EXE
  7.  and TW.EXE may be copied to any directory. It is recommended that the
  8.  directory TW.EXE and TWE.EXE are in be included in your DOS PATH.
  9.  
  10.  GENERAL INFO:
  11.  Text Watch (TW) will monitor your Text.INI file for changes and keep a
  12.  history of this changes stored in a seperate file.
  13.  
  14.  To make Text Watch simple, there are two types of changes that are
  15.  recorded, Addtions and Deletions. Lines which have been edited will be
  16.  reported as Deleted and Added, its not a bug. In fact if you think about
  17.  it, you will understand why an edited change is recorded twice. Text Watch
  18.  has a limit of about 51K size ASCII files. Text Watch is intented for
  19.  configuration type text files and has the following limitations which may be
  20.  adjusted as demand requires:
  21.  
  22. 1. Blank lines                        (TW will remove blank lines when reset)
  23. 2. Lines greater than 80 characters   (Line is truncated to 80 characters)
  24. 3. Files Greater than 640 lines       (TW will not process, TWE will truncate
  25.                                        file in memory, not on disk unless it is
  26.                                        saved)
  27.  
  28.  Text Watch or TW will monitor other files besides your WIN.INI
  29.  file, but WIN.INI is the default if no name is supplied at the
  30.  command line. When an option has been selected which can change
  31.  or remove stuff, a confirmation prompt will be displayed asking
  32.  you if you are sure (EXCEPT if you use /B). Think before selecting
  33.  Yes or using the /B option.
  34.  
  35.  Below is a list of TW critical files that TW creates for each Watch
  36.  file. You should not erase any of them (with the exception of *.TW)
  37.  if you wish TW to operate properly :
  38.  
  39.    The Watch Filename    ->     WIN.INI      or anyfile
  40.  
  41.    TW Creates:
  42.  
  43.    The Original Backup   ->     WIN.TW       or anyfile.TW
  44. *  The Last Change File  ->     L_WIN.TWL    or L_anyfile.TWL
  45. *  The History File      ->     WIN.TWH      or anyfile.TWH
  46.  
  47.  Files with a * next to them are hidden from a normal directory search.
  48.  
  49.  
  50.  The Watch File (any ASCII Text file):
  51.  This is the file which you wish to Watch for changes.
  52.  
  53.  The Original Backup:
  54.  This file is created by TW the first time the file is monitored so
  55.  that if total disaster strikes. You can resort back the original.
  56.  If you delete this file, TW will make another *.TW file of the
  57.  current file. (its better to just leave this file alone)
  58.  
  59.  The Last Change File (L_*.TWL):
  60.  This file is compared with the Watch File for changes. First the
  61.  file sizes are checked, then the file date and time are compared.
  62.  If any of these do not compare TW assumes the Watch File has been
  63.  changed and begins comparing the Last Change File and the Watch
  64.  file for Additions and Deletions. The results are stored in the
  65.  *.TWH file or History file. The Last Change File is then updated to
  66.  match the Watch file. If you delete this file or TW cannot find it
  67.  in the current directory, TW will assume it hasn't been run on this
  68.  file and Enable itself. This file is by default, always hidden from
  69.  view unless option /U is used.
  70.  
  71.  The History File (*.TWH):
  72.  This file keeps a running list of changes to the Watch file and
  73.  includes the Date and Time of the change and the actual changes.
  74.  This file is by default, always hidden from view unless option /U
  75.  is used.
  76.  
  77.   CAUTION: Be very careful if you decide to edit your history file.
  78.            Incorrect changes to you History file can lead to unexpected
  79.            results or lost data in the file when you run TW. See your
  80.            registered user Manual for History file formats.
  81.  
  82.  
  83.  TW.EXE (Text Watch)
  84.  For best use, install TW.EXE and TWE.EXE in a directory that is included
  85.  in your search PATH.
  86.  
  87.  TW is run from the command line or from TWE  before a file may be modified
  88.  and then after at some point. The best way to use TW is in a Batch file,
  89.  such as a WINDOWS.BAT with the command:
  90.                          TW *.INI   <-- This will check all INI files
  91.                          WIN
  92.  Then the next time you run Windows you will be notified if this file has
  93.  changed, and what was changed.
  94.  
  95.  
  96.  The TW Text Watch Status line comment meanings:
  97.  
  98.  (ENABLED)          = Text Watch has set this file up to be watched
  99.  (DISABLED)         = Text Watch has removed its files. File is not setup to
  100.                       be watched.
  101.  (OPTIMIZED n)      = n Blank or Empty lines were removed from file.
  102.  (UPDATED)          = History and Last Change File updated with new changes.
  103.  (REVERSED)         = Last changes to file have been reversed
  104.  (CONFLICT CHECK)   = See Option /1
  105.  
  106.  (CHANGES Detected)      = Changes found in file since last checked.
  107.  (NO CHANGES Detected)   = No changes found in file since last checked.
  108.  
  109.  
  110.  TW has the following usage format:  (Each option is seperated by a space)
  111.  
  112.  Descriptions followed by an * indicate a confirmation prompt is displayed
  113.  asking you if you are sure before the action is executed unless the /B
  114.  option was used.
  115.  
  116.         TW FileSpec <Options>
  117.  
  118.         Options:  /B  = Bypass Confirmation prompt.
  119.                         Using this option will cause all Are You Sure
  120.                         prompts to bypassed as if Yes were selected.
  121.                         Careful here, this used in combination with the
  122.                         /C or /E switch could be trouble.
  123.  
  124.                   /C  = Clear History File and Settings (Reset)
  125.                         Wipes out any entries in your history file.
  126.                         Sets files as if it were the first time TW was
  127.                         run on the selected filespec.*
  128.  
  129.                   /D  = Do Not make *.TW file (ie. Original Backup)
  130.                         Do not make a backup copy of this file before
  131.                         Resetting file Information. This option should
  132.                         be included each time TW is run if you do not
  133.                         wish a *.TW file to be created.
  134.                         CAUTION: It is recommended  you do Not use this
  135.                                  option unless you are an experienced
  136.                                  user.
  137.  
  138.                   /E  = Erase TW watch files in directory. Any FileSpec
  139.                         entered is disregarded, so be careful if you
  140.                         use the /B option or all TW files in the directory
  141.                         will be removed. *
  142.                         (TW Files: anyfile.TW, anyfile.TWL, and anyfile.TWH)
  143.  
  144.                   /L  = Reverse Last Change in History File
  145.                         Restore the last change in your history file to
  146.                         your Watch file.*
  147.  
  148.                   /P  = Pause before exiting TW.
  149.                         Its good to use this switch when running from TWE.
  150.                         TW will pause with a 'Press any key' message before
  151.                         returning to TWE or DOS
  152.  
  153.                   /R  = Reverse any New changes.
  154.                         Automatically will restore this file to old copy
  155.                         whenever a new change is detected.*
  156.  
  157.                   /S  = Display any Changes on Screen.
  158.                         Display the text that was changed on the screen.
  159.                         Show added and deleted text.
  160.  
  161.                   /T  = Show all History files that TW is using in the
  162.                         selected directory. Any FileSpec entered is
  163.                         disregarded and all TW History files are listed.
  164.  
  165.                   /U  = Do not Hide or Unhide TW watch files. Must be
  166.                         used each time TW is run to keep these files
  167.                         unhidden.
  168.  
  169.                   /1  = Check for filename conflicts (ie. SYSTEM.INI and
  170.                         SYSTEM.BAT in same directory) in current directory
  171.                         using FileSpec. If any conflict is found TW will
  172.                         exit to DOS after displaying files which may
  173.                         conflict and the message (CONFLICT DISCOVERED),
  174.                         otherwise (NO CONFLICT FOUND) will be displayed
  175.                         TW will continue. This switch is only useful when
  176.                         DOS wildcards are used for the FileSpec.
  177.  
  178.  
  179.  
  180.  I like to use the following command line for my INI files:
  181.  
  182.    TW *.INI /P /S
  183.  
  184.  This will check (or the first time, reset) all my INI files, Display
  185.  a list of changes, if any, and Pause before exiting to TWE or DOS.
  186.  This is the best option to use for Windows. If you restore one INI
  187.  file that has changed you should also restore your other INI files
  188.  which have also changed.
  189.  
  190.  TW C:\WINDOWS\*.INI /R     Will reverse any changes it finds in your
  191.                             INI files.
  192.  
  193.  TW C:\WINDOWS\*.INI /L     Will reverse the last changes that were
  194.                             recorded in the INI files History File.
  195.  
  196.  TW C:\WINDOWS\*.INI /L /B  Will perform the same operation as above with
  197.                             no confirmation prompt.
  198.  
  199.  NOTE: TW and TWE do not process Blank lines. In fact, blank lines in
  200.        your INI files make Windows startup slower. Text Watch (TW.EXE) will
  201.        remove Blank lines when a history file is reset. See  (OPTIMIZED)
  202.        under Text Watch Status.
  203.  
  204.  
  205.  CAUTION:
  206.         Be careful when using wildcards in the FileSpec because
  207.         files which aren't true ASCII text files will be processed
  208.         incorrectly. If you do use TW on a binary file restore the
  209.         *.TW (ie. Original Backup) Also, as an added safety feature
  210.         TW will Not process (Watch) files with the extensions:
  211.  
  212.         *.TW   *.TWH  *.TWL  *.COM  *.EXE  *.OBJ  *.PIF  *.DLL
  213.         *.GRP  *.PCX  *.OVL  *.BMP  *.GIF  *.PIC  *.BIN
  214.  
  215.         It is not safe to use the filespec *.* since some files may not
  216.         be ASCII and have different extensions than those listed above.
  217.  
  218.  
  219.  
  220.  TWE.EXE (Text Watch Editor)
  221.  
  222.  Usage:  TWE <filename>
  223.  
  224.  TWE allows you to edit any text files that are 640 lines or less. (the
  225.  limit for TW as well, which is about 51K) You can also run TW from within
  226.  TWE and restore selected last changes. TWE is alot more powerful (and more
  227.  dangerous) than TW and allows for reverse to anywhere in your history file
  228.  and you are not forced to restore all last changes like in TW. Below is a
  229.  listing of keys available in the editor and short descriptions of their
  230.  functions. The TW Editor is compatible with WIN.INI files. To load a file
  231.  and go directly to the TWE editor, type a space, then the filename.
  232.  
  233.  F1    = Help, brings up display of available keys
  234.  F2    = Save current edit file, if being watched by TW then scan for
  235.          changes.
  236.  F3    = Load/Create, Load or create another file.
  237.  F4    = Mark   Block, Mark lines of text to copy or delete
  238.  F5    = Copy   Block, Copy Marked lines to cursor
  239.  F6    = Delete Block, Delete Marked Lines
  240.  F7    = Change Editor Colors, Changed the colors of the editor
  241.  F8    = Print File, Print the current edit file to selected printer
  242.  F9    = Show File Change History, Show History file for current edit file
  243.  F10   = Restore Last History Changes, Restore last changes, you are prompted
  244.          before each change is made.
  245. Esc    = Exit/Save
  246. Alt-D  = Show current Path
  247. Alt-I  = Information on current file Item, If you are editing your
  248.          WIN.INI or CONFIG.SYS file, place the cursor at the item you wish more
  249.          information on and press the Alt-I keys. Press and hold down the Alt
  250.          key, then press the I key at the same time.
  251.  
  252.          This option may include information on other files such as SYSTEM.INI,
  253.          and AUTOEXEC.BAT in future releases depending on the number of
  254.          registrations and requests for it. You may also create your on info
  255.          file by following the Format and nameing conventions of WIN.HLP or
  256.          CONFIG.HLP files. (ie. WIN.HLP for WIN.INI, CONFIG.HLP for CONFIG.SYS)
  257. Alt-S  = Search and/or Replace text. At the replace prompt press the enter key
  258.          if you on wish to search for text.
  259.  
  260.  
  261.   Distribution Guidelines:
  262.  
  263.   TW may be distributed freely as long as the following guidelines are
  264.   observed:
  265.  
  266.   1) Is distributed with all files in the Original Compressed format and
  267.      no file is modified.
  268.   2) No charge be incurred other than a minimal shipping & handling fee
  269.      not to exceed $10 US dollars
  270.  
  271.  Below is a list of files which should be contained on your Shareware Diskette
  272.  or compressed file.
  273.  
  274.  Files having an * preceding them may be erased if not used, or in the case
  275.  of INSTALL.EXE, after it is used.
  276.  
  277.  Filename        Date    Time    Description
  278.  -------------   ----    ----    --------------------------------------------
  279. *INSTALL.EXE   00-00-80  00:00   Install TW.EXE and TWE.EXE use
  280.  TW.EXE        00-00-80  00:00   Text Watch Command line utility
  281.  TWE.EXE       00-00-80  00:00   Text Watch Editor utility
  282.  EDITOR.HLP    00-00-80  00:00   Text Watch Editor help
  283. *WIN.HLP       00-00-80  00:00   WIN.INI Information on Item Help File
  284. *CONFIG.HLP    00-00-80  00:00   CONFIG.SYS Information on Item Help File
  285. *TWMAN.DOC     00-00-80  00:00   General Information and Directions for use
  286.  REGISTER.DOC  00-00-80  00:00   Your Registration form for Text Watch
  287. *READ.ME       00-00-80  00:00   Last minute update or information
  288. *PRINTREG.BAT  00-00-80  00:00   Print your registration form
  289.  
  290.  For questions or to request customized versions of TW send an EMAIL to Mark
  291.  Vitt CompuServe ID 70053,2236. Complete Manual and Newest Version is available
  292.  to registered users only. See REGISTER.DOC for more information.
  293.  
  294.  This is a Shareware Program - After a 30 day trial you are required either
  295.  to Register your copy or remove it from use on your system. See REGISTER.DOC
  296.  for registration information.
  297.  
  298.  Using any Shareware software for more than 30 days without registering is
  299.  federal copyright enfringement under the provisions of section 410(a) of
  300.  title 17, United States Code. VitCom International and/or Mark Vitt offer
  301.  a minimum reward of one hundred dollars to anyone who supplies information
  302.  leading to the arrest and/or civil proceedings of persons using our Shareware
  303.  software for more than 60 days without registering.
  304.